package com.onepunch.common;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import org.springdoc.core.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SwaggerConfig {
    // 配置API文档的基本信息
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                // 文档标题、版本、描述
                .info(new Info()
                        .title("一拳小程序API文档")
                        .version("1.0")
                        .description("包含攻略的CRUD、分页、条件查询等接口")
                        .contact(new Contact() // 作者信息（可选）
                                .name("开发团队")
                                .email("")));
    }

    // 配置接口扫描规则（只扫描Controller层）
    @Bean
    public GroupedOpenApi userApi() {
        // 扫描com.example.springbootdemo.controller包下的接口
        return GroupedOpenApi.builder()
                .group("攻略管理接口") // 接口分组名称
                .packagesToScan("com.onepunch.controller")
                .build();
    }
}
